home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / Help-files / DVIDVI < prev    next >
Text File  |  1996-12-24  |  4KB  |  90 lines
  1. The dvidvi program does pagination tricks with dvi files.
  2. It converts a dvi file into another dvi file, with optional changes
  3. based on various parameters.  The "easy" parameters are the following:
  4.  
  5.    -f n     page n is first page selected
  6.    -l n     page n is last page selected
  7.    -n n     select at most n pages; n is independent of the number
  8.             of pages actually contained in a sheet
  9.    -i { n1..n2 | n1 }[,...]
  10.             include given pages (ranges allowed). When this option is
  11.             used, ONLY the specified pages are selected. However,
  12.             we can exclude from these pages with the option -x
  13.    -x { n1..n2 | n1 }[,...]
  14.             exclude given pages (ranges allowed)
  15.    -r       reverse the order of the pages
  16.  
  17. The page numbers for the options -f -l -i and -x can be specified in
  18. different ways:
  19.  
  20. 1. If a number n is given, it is interpreted as the nth page from the
  21. begining of the dvi file. Of course, this number is independent of the
  22. page number assigned by TeX.
  23.  
  24. 2. TeX page numbers are those actually written on the page.
  25. A TeX page number can be specified by preceding the number n with the
  26. character @. Thus, if you specify -f @25 -l @30 you select the pages
  27. between 25 and 30, these numbers being those assigned by TeX.
  28.  
  29. 3. However, several pages can have the same TeX page number in a dvi file.
  30. For example, the introductory pages in a book are numbered i, ii, and so on
  31. until the first chapter begins and then, the pages are numbered 1, 2, etc.
  32. In this case, the pages numbered i and 1 in the .dvi file have the same TeX
  33. page number. If you want to select for example the second occurrence of the
  34. page numbered 1, you can specify a page number as (@2)1. Thus @1 is equivalent
  35. to (@1)1. For example, if you specify -f (@2)1 -l(@2)10 you select the pages
  36. between 1 and 10 of the first chapter, not the introductory pages between
  37. i and x.
  38.  
  39. There is another parameter that tells dvidvi how you want to change page
  40. layout and specifications. This is the -m parameter.
  41.  
  42. The number preceding the colon is the modulo value.  Everything will
  43. be done in chunks of pages this big.  If there is no colon, then the
  44. default value is assumed to be one.  The last chunk of pages is padded
  45. with as many blank pages as necessary.
  46.  
  47. Following the colon is a comma-separated list of page numbers.
  48. These page numbers are with respect to the current chunk of pages, and
  49. must lie in the range zero to the modulo value less one.  If a negative
  50. sign precedes the number, then the page is taken from the mirror chunk;
  51. if there are m chunks, then the mirror chunk of chunk n is the chunk
  52. numbered m-n-1.  Put simply, it is the chunk numbered the same, only
  53. from the end.  This can be used to reverse pages.  If no number is
  54. given, the page number defaults to 1.
  55.  
  56. Following each page number is an optional offset value in
  57. parenthesis, which consists of a pair of comma-separated dimensions.
  58. Each dimension is a decimal number with an optional unit of measure.
  59. The default unit of measure is inches, or the last unit of measure
  60. used.  All units are in true dimensions.  Allowable units of measure
  61. are the same that TeX allows:  in, mm, cm, pt, pc, dd, and cc.
  62.  
  63. Simple enough, eh?  Okay, let's do some simple things.
  64.  
  65. -m 2:0    Selects the first, third, fifth, etc. pages from the file.
  66.           Print this one after printing the next, taking the paper out
  67.           of the feed tray and reinserting it into the paper feed.
  68.  
  69. -m 2:-1   Selects the second, fourth, etc. pages, and writes them in
  70.           reverse order.
  71.  
  72. -m 4:-1,2(4.25in,0in)
  73. -m 4:-3,0(4.25in,0in)
  74.           Useful for printing a little booklet, four pages to a sheet,
  75.           double-sided, for stapling in the middle.  Print the first,
  76.           put the stack back into the printer upside down, and print
  77.           the second.  The "in" specifications are superfluous.
  78.  
  79. -m ,(1pt,1)
  80.           Scare your system administrator!  Actually, things are so
  81.           blurry with this option, you may want to send enemies letters
  82.           printed like this.  *Long* letters.
  83.  
  84. -m 4:0(5.5in,4.25),3(0,4.25)
  85. -m 4:1(0in,4.25),2(5.5,4.25)
  86.           Print a four-page card on one sheet.  Print the first, rotate
  87.           the paper 180 degrees and feed it again.
  88.  
  89. Enjoy.
  90.